Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-LAP-027 |
| Deskripsi | Laporan hutang supplier dalam beberapa mode: hutang rinci, per supplier, kartu hutang, umur hutang, hutang jatuh tempo, dan hutang pajak, lengkap dengan cetak dan ekspor |
| Nomor Revisi | 1 |
| Tanggal | 2026-10-04 |
| Keterangan | Dokumentasi baseline dari dokumentasi fitur demo dan kode FE |
1. Ringkasan
a. In scope
- User membuka Laporan Hutang dari daftar Laporan Pembelian.
- User memilih mode laporan: hutang rinci, hutang per supplier, kartu hutang, umur hutang, hutang jatuh tempo, atau hutang pajak.
- User mengisi tanggal posisi hutang (atau periode bulan untuk kartu hutang), memilih supplier, dan mengurutkan hasil.
- User memakai filter tambahan: rentang jatuh tempo dan nominal sisa hutang (lebih dari, kurang dari, sama dengan).
- User melihat sisa hutang per invoice, total per supplier, mutasi masuk keluar hutang, hutang jatuh tempo, dan pengelompokan umur hutang.
- User mencetak atau mengunduh PDF dan mengekspor Excel sesuai hak akses.
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Sistem menampilkan sisa hutang per invoice per tanggal posisi beserta total sisa hutang brand |
| FR-02 | Sistem menampilkan total sisa hutang per supplier beserta invoice di dalamnya |
| FR-03 | Sistem menampilkan kartu hutang: saldo dan mutasi masuk keluar hutang per supplier dalam periode bulan |
| FR-04 | Sistem menampilkan umur hutang per supplier |
| FR-05 | Sistem menampilkan hutang yang jatuh tempo sampai tanggal tertentu |
| FR-06 | Sistem menampilkan hutang pajak terkait PPh |
| FR-07 | User dapat memfilter supplier, rentang jatuh tempo, dan nominal sisa, serta mengurutkan hasil |
| FR-08 | User dengan izin print dapat mencetak atau mengunduh PDF laporan |
| FR-09 | User dengan izin Excel dapat mengekspor laporan ke Excel |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Melihat hutang rinci per tanggal |
| UC-02 | Melihat hutang per supplier |
| UC-03 | Melihat kartu hutang supplier |
| UC-04 | Melihat umur hutang |
| UC-05 | Melihat hutang jatuh tempo |
| UC-06 | Melihat hutang pajak |
| UC-07 | Memfilter hutang berdasarkan jatuh tempo dan nominal sisa |
| UC-08 | Mencetak atau mengekspor laporan hutang |
4. Use Case Scenario
UC-01 : Melihat hutang rinci per tanggal
| Aktor | User akuntansi / pembelian |
| Deskripsi | User melihat seluruh invoice hutang yang belum lunas pada tanggal posisi tertentu |
| Prekondisi | User memiliki izin akses #lap-hutang |
| Alur utama | 1. User membuka Laporan Pembelian lalu Laporan Hutang. 2. User memilih mode hutang rinci dan tanggal posisi hutang. 3. User memilih urutan (nama, tanggal, nomor invoice, sisa hutang, atau tanggal jatuh tempo). 4. User menekan tombol lihat laporan. 5. Sistem menampilkan invoice hutang: supplier, nomor, tanggal, jatuh tempo, sisa, umur hari, serta total sisa brand. |
| Alur negatif | - Jika form tidak valid, muncul alert "Form Harus Diisi!". - Jika periode tidak lengkap, muncul alert "Periode Tidak Boleh Kosong". - Jika tidak ada data, muncul "Belum ada data yang ditampilkan" atau "Data yang anda cari tidak ditemukan". |
| Bisnis rule | - Hanya invoice hutang non draft dan tercetak yang dihitung. - Default hanya hutang dengan sisa lebih dari 0. - Mode default halaman adalah hutang rinci. - Halaman terpisah /laporan-hutang-rinci tidak terhubung dari menu hub; mode hutang rinci di halaman ini yang dipakai. |
| Postkondisi | Daftar hutang rinci tampil |
| Trigger | User menekan tombol lihat laporan |
| Kode FR | FR-01 |
UC-02 : Melihat hutang per supplier
| Aktor | User akuntansi / pembelian |
| Deskripsi | User melihat total sisa hutang dikelompokkan per supplier |
| Prekondisi | User memiliki izin #lap-hutang |
| Alur utama | 1. User memilih mode hutang supplier dan tanggal posisi. 2. User dapat memilih satu atau beberapa supplier. 3. User menekan lihat laporan. 4. Sistem menampilkan agregat per supplier dan daftar invoice di dalamnya. |
| Alur negatif | - Jika form tidak valid, muncul alert "Form Harus Diisi!". - Jika data kosong, tabel kosong. |
| Bisnis rule | - Data dasar memakai sisa hutang per invoice lalu dikelompokkan per supplier di tampilan. |
| Postkondisi | Agregat hutang per supplier tampil |
| Trigger | User menekan tombol lihat laporan |
| Kode FR | FR-02 |
UC-03 : Melihat kartu hutang supplier
| Aktor | User akuntansi / pembelian |
| Deskripsi | User melihat mutasi hutang per supplier dalam periode bulan |
| Prekondisi | User memiliki izin #lap-hutang |
| Alur utama | 1. User memilih mode kartu hutang. 2. User mengisi rentang bulan dan supplier opsional. 3. User menekan lihat laporan. 4. Sistem menampilkan saldo dan mutasi masuk keluar hutang per supplier. |
| Alur negatif | - Jika periode bulan kosong, muncul alert "Periode Tidak Boleh Kosong". |
| Bisnis rule | - Kartu hutang memakai filter periode bulan, bukan tanggal tunggal. - Urutan daftar disembunyikan pada mode ini. |
| Postkondisi | Kartu hutang tampil |
| Trigger | User menekan tombol lihat laporan |
| Kode FR | FR-03 |
UC-04 : Melihat umur hutang
| Aktor | User akuntansi / pembelian |
| Deskripsi | User melihat pengelompokan umur sisa hutang per supplier |
| Prekondisi | User memiliki izin #lap-hutang |
| Alur utama | 1. User memilih mode umur hutang dan tanggal posisi. 2. User menekan lihat laporan. 3. Sistem menampilkan sisa hutang yang dikelompokkan berdasarkan umur per supplier. |
| Alur negatif | - Jika form tidak valid, muncul alert "Form Harus Diisi!". |
| Bisnis rule | - Pengelompokan umur dilakukan di tampilan dari data sisa hutang per invoice. |
| Postkondisi | Laporan umur hutang tampil |
| Trigger | User menekan tombol lihat laporan |
| Kode FR | FR-04 |
UC-05 : Melihat hutang jatuh tempo
| Aktor | User akuntansi / pembelian |
| Deskripsi | User melihat hutang yang jatuh tempo sampai tanggal tertentu |
| Prekondisi | User memiliki izin #lap-hutang |
| Alur utama | 1. User memilih mode hutang jatuh tempo dan tanggal. 2. User dapat memilih supplier. 3. User menekan lihat laporan. 4. Sistem menampilkan invoice hutang jatuh tempo. |
| Alur negatif | - Jika form tidak valid, muncul alert "Form Harus Diisi!". |
| Bisnis rule | - Dropdown unduh/cetak disembunyikan pada mode hutang jatuh tempo. |
| Postkondisi | Daftar hutang jatuh tempo tampil |
| Trigger | User menekan tombol lihat laporan |
| Kode FR | FR-05 |
UC-06 : Melihat hutang pajak
| Aktor | User akuntansi / pajak |
| Deskripsi | User melihat hutang terkait pajak PPh |
| Prekondisi | User memiliki izin #lap-hutang |
| Alur utama | 1. User memilih mode hutang pajak dan tanggal. 2. User menekan lihat laporan. 3. Sistem menampilkan daftar hutang pajak. |
| Alur negatif | - Jika form tidak valid, muncul alert "Form Harus Diisi!". |
| Bisnis rule | - Filter person pajak memakai jenis PPh terkait. |
| Postkondisi | Laporan hutang pajak tampil |
| Trigger | User menekan tombol lihat laporan |
| Kode FR | FR-06 |
UC-07 : Memfilter hutang berdasarkan jatuh tempo dan nominal sisa
| Aktor | User akuntansi / pembelian |
| Deskripsi | User mempersempit hasil laporan hutang dengan filter tambahan |
| Prekondisi | Mode laporan sudah dipilih |
| Alur utama | 1. User membuka modal filter. 2. User mengisi rentang tanggal invoice atau jatuh tempo dan/atau batas nominal sisa. 3. User menerapkan filter lalu melihat laporan. |
| Alur negatif | - Jika rentang tanggal tidak lengkap, muncul alert "Periode Tidak Boleh Kosong". |
| Bisnis rule | - Default filter nominal: sisa lebih dari 0. - Invoice draft dikecualikan; hanya invoice tercetak. |
| Postkondisi | Filter diterapkan pada permintaan laporan |
| Trigger | User menerapkan filter lalu melihat laporan |
| Kode FR | FR-07 |
UC-08 : Mencetak atau mengekspor laporan hutang
| Aktor | User dengan izin print atau Excel |
| Deskripsi | User mencetak, mengunduh PDF, atau mengekspor Excel laporan hutang |
| Prekondisi | Data laporan sudah tampil; user punya izin print atau excel |
| Alur utama | 1. User memilih unduh atau cetak sesuai mode. 2. Sistem menyusun PDF/print atau file Excel per mode, mis. "Laporan Hutang Rinci.xlsx". 3. Pada hutang supplier, sheet detail pembayaran invoice dapat dilampirkan. |
| Alur negatif | - Jika form tidak valid, muncul alert "Form Harus Diisi!". - Jika data kosong, muncul "Data yang ingin ada print tidak ditemukan". |
| Bisnis rule | - Mode hutang jatuh tempo tidak menampilkan menu unduh/cetak. - Ekspor Excel memakai data yang sudah dimuat di halaman. |
| Postkondisi | File Excel atau cetakan tersedia |
| Trigger | User menekan unduh atau cetak |
| Kode FR | FR-08 FR-09 |
5. Data Flow Diagram
DFD-01 — Alur data laporan hutang
6. Sequence Diagram
SD-01 — UC-01 : Melihat hutang rinci per tanggal
SD-02 — UC-02 : Melihat hutang per supplier
SD-03 — UC-03 : Melihat kartu hutang supplier
SD-04 — UC-04 : Melihat umur hutang
SD-05 — UC-05 : Melihat hutang jatuh tempo
SD-06 — UC-06 : Melihat hutang pajak
SD-07 — UC-07 : Memfilter hutang berdasarkan jatuh tempo dan nominal sisa
SD-08 — UC-08 : Mencetak atau mengekspor laporan hutang
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
POST /invoice-hutang/sisa-hutang-by-invoice | existing | - |
GET /invoice-hutang/saldo-bulk | existing | - |
GET /invoice-hutang/kartu-hutang | existing | - |
GET /invoice-hutang | existing | - |
POST /pembayaran-hutang/get-invoice | existing | - |
POST /supplier/get-supplier | existing | - |